Tableau Desktop 或 Tableau Prep Builder 安装疑难解答

安装 Tableau Desktop 或 Tableau Prep Builder 时，安装可能不会始终完全按照预期方式进行。在本主题中，您可以找到有关如何对您可能遇到的问题进行故障排除的信息，以及如何解决这些问题的相关建议。

为了帮助您快速找到问题的答案，您可以搜索 Tableau 知识库。知识库包含可用于解决问题的故障排除技术、描述已解决的已知问题并提供常见问题的答案。

安装修复是在现有安装的基础上安装相同版本的新内部版本的过程。修复安装通过覆盖更改的文件和重新安装丢失的文件来使软件保持工作状态。

若要运行安装修复，请执行以下操作：

如果您使用 Tableau 支持，他们可能会从您的安装中请求日志文件。Tableau Desktop 或 Tableau Prep Builder 可保留安装过程的日志。默认情况下为 Windows 和 Mac 的 Tableau 安装程序启用了日志记录。默认情况下，对于 Windows 和 Mac，日志文件分别存储在用户的临时文件夹（在 %temp% 环境变量中指定的位置）和 /private/var/log 中。最好保留安装过程的日志文件，以帮助您在遇到任何问题时排除故障。如果保留了日志文件，您可以查看该日志文件，并搜索包括 Error 或 Fail 的条目来帮助您找出问题。

注意：在 DEBUG 级别记录日志时，Tableau 启动时会收集完整的环境信息。这意味着，如果环境变量中有任何敏感信息，它可能会包含在日志中。在默认的 INFO 级别进行日志记录则只会收集安全环境信息。

如果要更改日志文件的位置或名称，或者如果您不确定是否启用了日志记录，请完成以下步骤。在开始安装之前，必须启用日志记录。

下载安装程序（.exe 文件）。

以管理员身份打开命令窗口。

导航到您将安装程序文件下载到的目录。

运行以下命令：

/log ""

将 installer 替换为 Tableau 安装程序文件的名称，并将 log_file_path_and_name 替换为想要在其中保存安装日志文件的文件的路径和名称。

例如：

tableauDesktop-64bit-2021-3-1.exe /log "C:\Users\henryw\Desktop\install.txt"。

如果 Tableau 许可服务无法读取或访问产品密钥，您可能会看到以下错误之一：

找不到“TableauDesktop”的许可证

无法添加许可证

函数 flxActCommonLicSpcPopulateFromTS 返回了错误 50030、71521、0

若要诊断和解决错误，请按所示顺序尝试此部分中的步骤。

1.验证系统日期和时间

验证计算机上的日期和时间是否设置为当前日期。如果计算机上的时钟设置为早于当前日期的日期，则无法激活 Tableau。

2.验证是否安装了 FlexNet Licensing Service。

安装 Tableau Desktop 时会自动安装 FlexNet Licensing Service。Tableau 需要此服务才能运行。在 Mac 上安装 Tableau Desktop 时，可能会提示您输入密码，为安装程序提供安装 FlexNet 的权限。对于 Windows，用户帐户设置中隐含了安装 FlexNet 的权限。

若要检查计算机上是否正确安装了许可服务，请完成以下步骤：

Windows

导航到以下文件夹：

C:\Program Files\Common Files\Macrovision Shared\FlexNet Publisher

验证该文件夹中是否有 FNPLicensingService 应用程序。

如果未安装 FlexNet 许可服务，请尝试重新安装 Tableau Desktop 或检查您的用户帐户权限设置。

Mac

启动终端应用程序。

键入以下命令以列出 FlexNet 目录的内容：

ls '/Library/Application Support/FLEXnet Publisher/Service/11.16.2/FNPLicensingService'

如果命令未返回任何内容，或者返回消息No such file or directory（无此文件或目录），则未安装许可服务。有关如何手动安装 FlexNet Licensing Service 的信息，请参见 Tableau 知识库中的在 Mac 上激活时出现错误：“FlexNet Licensing Service 在系统上不存在”(链接在新窗口中打开)。

3.验证 FlexNet Licensing Service 是否正在运行

如果验证了 FlexNet Licensing Service 已安装，请验证该许可服务是否正在运行。如果未在运行，您可能需要手动启动该服务。若要启动该服务，请根据您的操作系统完成下面的步骤，然后重新启动 Tableau Desktop。

Windows

从 Windows 的“开始”菜单中，打开 services.msc。

在“服务”对话框中，验证 FlexNet Licensing Service 的状态是否为“已启动”。

如果“启动”选项显示为灰色，请在列表中右键单击“FlexNet Licensing Service”，并选择“属性”。在“常规”选项卡上，单击“启动”，然后单击“确定”关闭对话框。

Mac

启动终端应用程序。

导航到 FlexNet 目录：

'/Applications/Tableau Desktop /Contents/Frameworks/FlexNet/'custactutil -view

例如， '/Applications/Tableau Desktop 2021.3.app/Contents/Frameworks/FlexNet/'custactutil -view

验证 FlexNet Licensing Service 是否正在运行。您应会看到 Trust Flags = FULLY TRUSTED 和 Status = ENABLED。

然后使用以下命令将输出保存到桌面上的一个文件：

/Applications/Tableau\ Desktop\ /Contents/Frameworks/FlexNet/custactutil -view > /users/$(whoami)/Desktop/licresults.txt

4.修复受信任的存储

如果 FlexNet Licensing Services 已安装并正在运行，但您仍然看到错误，则 Tableau 产品密钥信息可能有问题。若要解决此问题，请完成以下步骤以修复位于以及保存在受信任的存储中的密钥信息。

注意： 您将需要访问位于 bin 文件夹中的“客户激活实用工具”来执行这些步骤。

Windows

打开命令窗口，并导航到“客户激活实用工具”所在的目录。例如：

cd "C:\Program Files\Tableau\Tableau \bin"

其中 是您安装的 Tableau 产品版本。

键入以下命令：

custactutil –localrepair

启动 Tableau。

如果修复未成功，请键入以下命令以创建 LicResults.txt 文件：

custactutil -view >LicResults.txt

与技术支持(链接在新窗口中打开)联系，并包括您创建的 LicResults.txt 文件。

Mac

启动终端应用程序。

导航到 FlexNet 目录：

cd /Applications/Tableau Desktop .app>/Contents/Frameworks/Flexnet

输入以下命令：

./custactutil -localrepair

启动 Tableau。

如果修复未成功，请键入以下命令以创建 LicResults.txt 文件：

./custactutil -view > /users//licresults.txt

与技术支持(链接在新窗口中打开)联系，并包括您创建的 LicResults.txt 文件。

在启动 Tableau 并包括 -activate 选项时，激活过程会通过将 ERRORLEVEL 环境变量设置为退出代码来返回状态信息。如果激活成功， Tableau 应用程序退出代码为 0（零）。下表列出了激活过程中的退出代码及其含义。

如果激活失败，您还可以在 Tableau 日志文件中找到错误信息。日志文件位于当前用户的 Documents 文件夹下 My Tableau Repository 文件夹中的 Logs 文件夹内。例如：

/Users//Documents/My Tableau Repository/Logs

以下示例脚本显示了如何激活适用于 Windows 的 Tableau Desktop 并检查特定错误，例如无效的产品密钥 (536871018) 和一般许可问题 (536871012)。

Tableau Desktop 和 Tableau Prep Builder 需要特定防火墙和代理设置来加载地图视图、加载网页以及处理许可证请求。如果您遇到以下错误之一，组织网络的管理员需要对网络 Web 代理和防火墙配置设置进行更改。

许可过程请求脱机激活。

地图视图在 Tableau Desktop 中显示为空白。

仪表板中的网页加载失败。

无法加载联机地图。

有关如何为 Tableau Desktop 配置 Internet 访问的信息，请参见所需的地址和端口。所需的地址和端口

Tableau 许可服务已于 2018 年 10 月 6 日转移到新的数据中心。这意味着，需要特殊配置（例如静态 IP 允许列表）来访问 licensing.tableau.com 或 licensing.tableau.com 的任何环境将需要更新，然后您才能激活、刷新或停用 Tableau 产品密钥。

若要检查是否为此问题，请执行以下操作：

在 Web 浏览器中，导航到以下地址：

https://licensing.tableau.com

https://licensing.tableau.com

您应会看到“Test success.”（测试成功）页面。

正确配置 Tableau Server 和 Tableau Desktop 实例后，可在两个管理视图（Desktop 许可证使用量(链接在新窗口中打开)和 Desktop 许可证过期(链接在新窗口中打开)）中获得 Tableau Desktop 许可证使用量信息。如果无法看到这些视图，或者视图中没有数据，则许可证报告可能存在问题。下面各部分可帮助您找出故障原因。

有关如何配置 Tableau Desktop 报告的信息，请参见管理 Tableau Desktop 许可证使用情况。

只有 Tableau Server 管理员才能使用桌面许可证报告管理视图。如果在“服务器状态”页上看不到“桌面许可证使用量”和“桌面许可证过期”视图的链接（从“站点”菜单中选择“管理所有站点”），请验证以下各项：

您以 Tableau Server 管理员身份进行了登录。

您正在运行 Tableau Server 10.0 或更高版本，用户正在运行 Tableau Desktop 10.0 或更高版本。Tableau Desktop 许可证报告从 Tableau Server 和 Tableau Desktop 版本 10.0 开始提供。

许可证报告在 Tableau Server 中启用。（该功能默认情况下已禁用。）有关详细信息，请参见本指南的管理 Tableau Desktop 许可证使用情况一文中有关在 Tableau Server 上启用许可证报告的过程。

如果您未看到期望的数据，这可能是因为此处列出的原因之一。

默认情况下，Tableau Desktop 按八小时的间隔来报告许可数据。如果自从为报告配置 Tableau Desktop 实例以来还不到八小时，您可能在管理视图中看不到使用量数据。Tableau Desktop 运行时每八小时报告一次，在启动正确配置的 Tableau Desktop 实例时开始计小时数。

如果达到八小时后 Tableau Desktop 仍然没有运行，下次启动 Tableau Desktop 时会发送报告。配置 Tableau Desktop 实例之后至少要等待八个小时，然后再在“桌面许可证报告”视图中查找那些许可证。

以下事件会强制立即从正确配置的 Tableau Desktop 实例向 Tableau Server 报告：

激活 Tableau Desktop 10.0 或更高版本。

停用 Tableau Desktop 10.0 或更高版本。

针对 Tableau Desktop 版本 10.0 或更高版本的许可证更新维护。

为许可证报告配置要报告到的服务器地址时，如果已在运行 Tableau Desktop，则必须重新启动 Tableau Desktop。

如果自从针对报告进行配置以来 Tableau Desktop 尚未打开，您可能在管理视图中看不到使用量数据。只有当 Tableau Desktop 正在运行时，才会报告许可证信息。

验证是否为 Tableau Desktop 的实例正确配置了要报告到的 Tableau Server 地址。

使用 Tableau Desktop 计算机上的日志文件来帮助确定是否正确配置了实例。查找日志文件 %Documents%\My Tableau Repository\Logs\log.txt。搜索“licUsageReport" 要查找与许可证报告相关的条目。

下表列出了可以帮助确定许可证报告问题的日志消息。

Internet communication error: Couldn't connect to server (server_name).

Tableau Desktop 向不存在的服务器报告。

Tableau Desktop 正在向未运行的 Tableau Server 实例进行报告。

在 Mac 计算机上，在错误位置创建了 .plist 文件后，可能会记录此消息。例如，.plist 文件已创建到或已复制到 ~\Library\Preferences（而不是 \Library\Preferences）中。

在 Mac 计算机上，如果创建了 .plist 文件，但后来用一个新的或更改的服务器名称更新了该文件，并且未重新启动 Mac 计算机，则可能会记录此消息。

默认情况下，如果针对 Desktop 许可证报告进行了配置，Tableau Desktop 将每八小时向配置的一个或多个服务器进行报告。可在 Tableau Desktop 计算机上修改注册表或 .plist 文件来更改此间隔。对于故障排除，这特别有用。

若要从 Windows 计算机中更改 Tableau Desktop 向服务器报告的频率，请编辑注册表，向 ReportingServer 项中添加一个字符串值：

路径：HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\ReportingServer

名称：添加一个名为 scheduleReportInterval 的字符串值。

数据：Tableau Desktop 向服务器发送报告的间隔时间量（以秒为单位）。默认情况下，此值为 8 小时，如果没有条目，则使用默认值。如有必要，可增加此值以进行故障排除，但请记住，间隔越频繁，产生的网络流量就越多。

例如，下图显示的注册表配置使 Tableau Desktop 每小时（3600 秒）向配置的 Tableau 服务器进行报告。

若要针对 Mac 更改 Tableau Desktop 向服务器报告的频率，请编辑 /Library/Preferences 中的 com.tableau.ReportingServer.plist 文件，并添加 scheduleReportInterval 项。将此项设置为报告从 Tableau Desktop 到达配置的 Tableau Server 所需的时间长度（以秒为单位）。以下示例显示了一个 .plist 文件的内容，该文件配置为每小时（3600 秒）将信息发送到两个服务器（https://mytableau02:8010 和 http://mytableau）。

如果 Tableau 在计算机上耗尽了内存，则会显示内存不足错误。使用 Tableau Desktop 或 Tableau Prep Builder 时，以下因素可能会影响内存。

Tableau Desktop 版本。

如果在 64 位 Windows 操作系统上安装 64 位 Tableau Desktop，Tableau 最多可访问 8 TB 的系统内存。

您所分析的数据的大小和类型。例如，具有许多列和数百万行值的大型交叉表或显示许多标记的视图可能会很快耗尽内存。

计算机上运行的其他应用程序。

计算机上的操作系统。

若要解决内存不足问题，请考虑将操作系统或 Tableau 版本升级到 64 位计算机。这将使 Tableau 能够访问更大量的系统内存。

您也可以查看工作簿中的数据，以及在视图中显示数据时数据的聚合方式。不要显示多行值，这可能需要滚动很多次才能查看数据，应考虑显示摘要数据。当视图中的数据显示更具概要性的信息时，Tableau Desktop 会更加高效并占用较少内存，从而允许您和其他人向下钻取到特定区域以查看详细信息。

有关如何优化您的工作簿性能的详细信息，请参见 Tableau 帮助中的优化工作簿性能(链接在新窗口中打开)。

如果在 Dell 计算机上安装了 Tableau Desktop，并且该计算机上安装了较旧版本的 Dell Backup and Recovery (DBAR) 应用程序，则 Tableau 可能会在您尝试打开或保存工作簿或尝试访问数据源时意外关闭。这是因为，Dell Backup and Recovery 软件会干扰 Tableau Desktop 64 位版本的打开和保存操作。有关如何解决此问题的信息，请参见 Tableau 知识库中的在 Dell 计算机上打开或保存文件时出现“Tableau 已停止工作” 错误(链接在新窗口中打开)一文。

Tableau 会定期针对所有当前支持的 Tableau Desktop 版本提供维护更新。下表列出了为何可能无法在 Tableau Desktop 的特定安装版本上安装维护更新的原因。

选择产品密钥，然后单击“刷新”。关闭并重新启动 Tableau Desktop。

如果这未解决问题，或者如果维护日期不正确，请与 Tableau 支持人员联系。

如果您是管理员，请为用户打开或关闭产品更新。有关详细信息，请参见本指南中的控制 Tableau Desktop 的产品更新。